Skip to content

Conversation

@d-bytebase
Copy link
Contributor

Summary

  • Changed separator from double underscore (__) to single underscore (_) in all filename examples
  • Added explicit version pattern specification: ^[vV]?(\d+(\.\d+)*)
  • Replaced suffix-based migration type detection (e.g., _dml, _ghost) with comment-based approach
  • Added MySQL-specific migration type section documenting -- migration-type: ghost syntax
  • Removed File Organization and Best Practices sections as requested
  • Simplified documentation for improved readability

Changes Made

File Naming Convention

  • Updated from <Version>__<Description>_<Suffix>.sql to <Version>_<Description>.sql
  • Added regex pattern and examples for version format
  • Updated all examples throughout the document (timestamp, semantic, sequential)

Migration Type Detection

  • Replaced suffix table with simpler comment-based approach
  • Clearly marked as "MySQL Only"
  • Simplified explanation of gh-ost integration

Removed Sections

  • Change Type Suffixes table
  • File Organization recommendations
  • Best Practices examples

All changes align with the actual implementation documented in bytebase/action README.

🤖 Generated with Claude Code

- Change separator from double underscore (__) to single underscore (_)
- Add version pattern specification: ^[vV]?(\d+(\.\d+)*)
- Replace suffix-based migration type with comment-based approach
- Add MySQL-specific migration type section using -- migration-type: ghost
- Remove File Organization and Best Practices sections
- Simplify documentation for better readability

All changes align with the actual implementation in bytebase/action.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Copilot AI review requested due to automatic review settings December 2, 2025 08:04
@vercel
Copy link

vercel bot commented Dec 2, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
bytebase-com Ready Ready Preview Comment Dec 2, 2025 8:06am

@d-bytebase d-bytebase merged commit 179a974 into main Dec 2, 2025
9 checks passed
@d-bytebase d-bytebase deleted the docs/update-migration-naming-conventions branch December 2, 2025 08:07
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the migration file naming conventions in the GitOps workflow documentation to align with the actual Bytebase implementation. The changes transition from double underscore separators and suffix-based migration type detection to single underscore separators and comment-based type specification.

Key changes:

  • Changed filename separator from __ (double underscore) to _ (single underscore) in all examples
  • Added explicit regex pattern ^[vV]?(\d+(\.\d+)*) for version format specification
  • Replaced suffix-based migration type detection (_dml, _ghost) with comment-based approach (-- migration-type: ghost)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants